OpenEdge Development:<br />Progress 4GL Reference FRAME-VALUE function

Release 10.1A: OpenEdge Development:
Progress 4GL Reference

FRAME-VALUE function

During a data entry statement, returns the (character string) value of the input field that the cursor is in to the current input field. At other times, returns the (character string) value of the input field the cursor was last in.
Note: Does not apply to SpeedScript programming.

Syntax
FRAME-VALUE 
Example

When the user presses END-ERROR while running this procedure, the procedure displays the name and value of the field the user was updating, along with the name of the table that contains that field.
r-frval.p
FOR EACH customer:
  DISPLAY cust-num name address city state postal-code
    WITH 1 COLUMN DOWN COLUMN 20.
  SET address city state postal-code.
END.

DISPLAY
  "You were updating field:" FRAME-FIELD FORMAT "x(20)" SKIP
  "Of file:" FRAME-FILE SKIP
  "And it had the value:" FRAME-VALUE FORMAT "x(20)" SKIP(2)
  "When you pressed the END-ERROR key"
  WITH FRAME helper NO-LABELS COLUMN 20 ROW 14 NO-BOX. 
Notes
If the cursor is not in an enabled input field when the last input statement ends, FRAME-VALUE returns a null string.

FRAME-VALUE is set to blanks at the next pause (done by a PAUSE statement or automatically by Progress) or at the next READKEY statement.

FRAME-VALUE returns strings. If you use FRAME-VALUE to return a number, you must convert it prior to numeric comparisons. For example:
FIND customer WHERE cust-num=INTEGER(FRAME-VALUE) 
See also

FRAME-FIELD function, FRAME-FILE function, FRAME-VALUE function, PROGRAM-NAME function